From 9ef7b2f4aa9b8cb20a497e627e31b73b8b4d1169 Mon Sep 17 00:00:00 2001 From: Behnam Esfahbod Date: Thu, 31 Aug 2017 12:22:24 -0700 Subject: [PATCH] [doc/book] Expand installation.md Import install text and links from , as we want to drop that page and redirect it to here. See --- src/doc/book/src/01-01-installation.md | 35 +++++++++++++++++++------- 1 file changed, 26 insertions(+), 9 deletions(-) diff --git a/src/doc/book/src/01-01-installation.md b/src/doc/book/src/01-01-installation.md index 9f9052344..8428a9063 100644 --- a/src/doc/book/src/01-01-installation.md +++ b/src/doc/book/src/01-01-installation.md @@ -1,21 +1,38 @@ ## Installation -The easiest way to get Cargo is to get the current stable release of Rust by +### Install Stable Rust and Cargo + +The easiest way to get Cargo is to get the current stable release of [Rust] by using the `rustup` script: ```shell $ curl -sSf https://static.rust-lang.org/rustup.sh | sh ``` -This will get you the current stable release of Rust for your platform along -with the latest Cargo. +After this, you can use the `rustup` command to also install `beta` or `nightly` +channels for Rust and Cargo. + +### Install Nightly Cargo + +To install just Cargo, the current recommended installation method is through +the official nightly builds. Note that Cargo will also require that [Rust] is +already installed on the system. -If you are on Windows, you can directly download the latest stable Rust and nightly Cargo: +| Platform | 64-bit | 32-bit | +|------------------|-------------------|-------------------| +| Linux binaries | [tar.gz][linux64] | [tar.gz][linux32] | +| MacOS binaries | [tar.gz][mac64] | [tar.gz][mac32] | +| Windows binaries | [tar.gz][win64] | [tar.gz][win32] | -- [Rust (32-bit)](https://static.rust-lang.org/dist/rust-1.17.0-i686-pc-windows-gnu.msi) -- [Cargo (32-bit)](https://static.rust-lang.org/cargo-dist/cargo-nightly-i686-pc-windows-gnu.tar.gz) +### Build and Install Cargo from Source -- [Rust (64-bit)](https://static.rust-lang.org/dist/rust-1.17.0-x86_64-pc-windows-gnu.msi) -- [Cargo (64-bit)](https://static.rust-lang.org/cargo-dist/cargo-nightly-x86_64-pc-windows-gnu.tar.gz) +Alternatively, you can [build Cargo from source][compiling-from-source]. -Alternatively, you can [build Cargo from source](https://github.com/rust-lang/cargo#compiling-from-source). +[rust]: https://www.rust-lang.org/ +[linux64]: https://static.rust-lang.org/cargo-dist/cargo-nightly-x86_64-unknown-linux-gnu.tar.gz +[linux32]: https://static.rust-lang.org/cargo-dist/cargo-nightly-i686-unknown-linux-gnu.tar.gz +[mac64]: https://static.rust-lang.org/cargo-dist/cargo-nightly-x86_64-apple-darwin.tar.gz +[mac32]: https://static.rust-lang.org/cargo-dist/cargo-nightly-i686-apple-darwin.tar.gz +[win64]: https://static.rust-lang.org/cargo-dist/cargo-nightly-x86_64-pc-windows-gnu.tar.gz +[win32]: https://static.rust-lang.org/cargo-dist/cargo-nightly-i686-pc-windows-gnu.tar.gz +[compiling-from-source]: https://github.com/rust-lang/cargo#compiling-from-source -- 2.30.2